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-TITLE USSTEST 
- IDENT Y vb4 E800" 
S eeeeeenensencncnnnoncerennseeeneqenensnncecencoceeceneeseeeecesterereeeneeee 


COPYRIGHT (c) 1978, 1980, 1982, 1984 B 
DIGITAL EQUIPMENT CORPORATION, MAYNARD. MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


* 
® 
* 
i 
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN JACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
NCLUSION OF THE ABOVE COPYRIGHT NOTICE, TAS SOF to WARE OR OTHER * 
COPIES, THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
TRANSFERRED. ‘ 
® 

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE * 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT * 
CORPORATION. “ 
® 

® 

® 

® 

® 

* 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 


. 
* e@eeee ee ee eee ee eee eee 


PARAEAAAAAAALASALALALALALA SALES E SES AL ES ESSE SERRE SEE RARER RRR R EERE RRR ER SS SG 


facility: Example of User Written System Services 


“fbetrect 
This module contains an example of a program that invokes a sample 
user-written system service that is contained in a privileged 
shareable bats F The module USSDISP contains the sample service 
and associated dispatching code being invoked by this simple test 
program. 


“Link Command File: 


' 
Link Command file for USSTEST 
LINK USSTEST/MAP/FULL ,SYSSINPUT/OPTIONS 


Options file for USSTEST 
USS.EXE/SHARE 


*—--AAMM 


BUF : “Lone 0 ; Location to receive TODR contents 


: SBTTL Sample invocation of user written system service 

3¢ 

3; Functional Description: 

; s routine shows an invocation of the example user system service that 
3 will read the contents of the time of day register. 


As can be seen by this example, the privileged nature of the code used 
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to implement the reading of the TODR jis not yi 
For coding convenience and better maintainabil 
generated by macros patterned on the standard 


ENTRY USSTEST,*M<> 
PUSHAB BUF 

CALLS #1,G*USER_GET_TODR 
RET 


~ END USSTEST 
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gible to the caller. 
RY: the code can be 
VMS system service macros. 


Entry mask and definition 

Build argument List = set address for 
return value 

Invoke routine in or ivileged Library 
to get value from Time-of-day register 


VAX/VMS V4.0 
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